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Introduction 


The 6500 Extended Monitor is an extensive machine code debugging aid. 

It includes the following commands for 

- memory display and modification 

memory display and change 
memory dump 
memory fill 
memory move 
memory relocate 

- program debugging 

disassembly 

search for byte string 
search for character string 
breakpoint installation and control 
processor register display and change 
program execution 

- audio cassette input/output 

load 

save 

view 

- hexidecimal arithmetic 

calculate 

display overflow/remainder 
Loading the Extended Monitor 

The method for loading the Extended Monitor depends upon which version 
you are using. Refer to the appendix appropriate to your system. 

After the Extended Monitor has been loaded its prompter, a colon (:) is 
displayed. This is the Extended Monitor's command mode. 
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Extended Monitor Commands 


Each of the Extended Monitor commands is listed below. Any of these 
commands may be entered whenever you are in the command mode as indicated 
by the colon prompter. Many of the commands also have subconmands 
which can be entered only after the primary command has been entered. If 
an invalid command is entered, a "?" will be printed. 

In the command descriptions below, all addresses and data values are 
hexidecimal and the following abbreviations or special characters are used: 
Meaning 

<ClF> the line feed key on the keyboard 
<JlC> the carriage return (or return) key on the keyboard 

f an up arrow character. May be a t , A or a shift/N on some keyboards 

@ a commercial-at character. May be a shift/P on some keyboards 

Memory Display and Modification Commands 

@aaaa displays the address and contents of the location aaaa. 

New contents may or may not then be entered (two hex 
digits) followed by one of the following: 


<LF> 

n 

<CR> 


displays the next location 

displays the previous location 

prints the contents of the location as an 
ASCII or graphic character 


Dffffjtttt 
Fffff,tttt=dd 
Maaaa=ffff,tttt 


exits to the Extended Monitor command mode 

dumps the contents of memory locations ffff through tttt-1. 

fills memory locations ffff through tttt-1 with the value dd. 

moves the contents of memory from locations ffff through 
tttt-1 to the memory starting at location aaaa. 

Note: The distance of an upward move must be greater than 
the length of the move or data in the original 
locations will be overwritten (aaaa>=tttt or 
aaaa<ffff). 
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Raaaa=ffff,tttt 


Program Debugging ' 
/pffff 

Ndd...dd>ffff,tttt 

Wc.. .offff ,tttt 
Bn.aaaa 

En 

Gaaaa 

T 

C 

I 


relocates (moves) the contents of memory from locations 
ffff through tttt-1 to the memory starting at location 
aaaa and appropriately adjusts all three-byte 6500 in¬ 
struction operand addresses that refer to locations within 
the range of the move. (Adds (aaaa-ffff) to each operand 
address that is>=ffff and <=tttt-l.) 



Note: The distance of an upward move must be greater 
than the length of the move or data in the 
original locations will be overwritten (aaaa>=tttt 
or aaaa<ffff). 


disassembles 6500 machine code into 6500 mnemonic 
code from memory location ffff up. Disassembly 
continues for a total of 24 lines - a maximum of 
72 bytes. At completion awaits: 

<LF> disassembles the next 24 lines 

<CR> exits to the Extended Monitor command mode 

searches the contents of memory locations ffff 
through tttt-1 for the string of 1 to 8 data bytes 
dd...dd. 

searches the contents of memory locations ffff through| 
tttt-1 for the string of 1 to 8 ASCII characters c...c: 


installs breakpoint n (n = 1-8) at address aaaa. 

The contents of location aaaa is saved and may be 
restored with the En command. If breakpoint n had 
previously been assigned it is first restored. 

When a breakpoint is "hit" during program execution 
it is also automatically restored. (See Using Break¬ 
points for Program Debugging) 

eliminates breakpoint n (n = 1-8) and restores the 
original contents of the location where it was located. 

goes (transfers program control) to address aaaa. 


prints a table of breakpoint addresses for each break¬ 
point 1 through 8. An address of FFFF indicates an 
unassigned breakpoint. 

continues program execution from the location of the 
last breakpoint. This command must only be used 
after a breakpoint has been "hit". 


prints the address of the last breakpoint "hit" and 
the contents of the A, X, Y, processor status (P) 
and stackpointer (K) registers as they existed at 
that breakpoint. 
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A, X, Y, P, K these five commands print the contents the associated 

register. New contents may or may not then be entered 
(two hex digits) followed by one of the following; 

" prints the contents of the register as 

an ASCII or graphic character 

<CR> exits to the Extended Monitor command mode 


Audio Cassette Commands 


Sffff.tttt saves the contents of memory locations ffff through tttt-1 

by writing them to the cassette port (as well as the terminal) 
in checksum format. This function may be terminated by 
typing "L" and a space. 

L loads into memory the data read from the cassette port in 

checksum format. If a checksum error is detected, "ERR" 
is printed. To recover, stop the cassette machine, rewind 
the tape a short distance and restart playing it. Type an 
"L" to restart the loading. The LOAD command can be exited 
at any time by typing a space. 

V view the data read from the cassette port in checksum format. 

Same as Load, above, but displays the data without modifying 
memory. 

The checksum format is as follows for each "record" of data: 


;18aaaadd...ddcccc 


where: 


1 

is the start of record character 


18 

is the hexidecimal number of data bytes in the 
record (24 decimal) 

aaaa 

is the address of the first data byte 
record 

in the 

dd...dd 

are the 24 data bytes 


cccc 

is the checksum - a sum modulo 65536if 
bytes in the record after the start oi 
character 

j of all 


■ record 


Each record is followed by a carriage return, line feed and nulls. 
Additional Commands 


Hxxxx,yyyy+ calculates the sum of hexidecimal values xxxx and yyyy and 
prints the result. The following operators are available 
in addition to +: 
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difference, xxxx-yyyy 
* product, xxxx*yyyy 

/ quotient, xxxx/yyyy 

0 prints the overflow or remainder from the last multiplication 

or division performed with the H command. 


/ 



Data Block Moves vs. Program Relocation 

The Move command moves the contents of memory without changing any of 



the moved data. The Relocate command also moves the contents of memory, 
but it also adjusts the operands of moved 6500 instructions to reflect their 
new location. For example, consider the following portion of a program 
residing at 0300 to 0380. 


0300 

A520 

LDA $20 

0302 

206E03 

« 

• 

JSR $036E 

036E 

• 

8DC6D0 

STA $D0C6 


If the command "M0500=0300,0380" was executed, the code would be moved, 
unchanged, to 0500 and would appear there unchanged. This code at 0500 would 
only "work" as long as the subroutine at 036E remained. 

If, on the other hand, the command "R0500=0300,0380" were used to make 
the move, the moved instructions would be relocated and would appear as: 


0500 

A520 

LDA $20 

0502 

206E05 

JSR $056E 

056E 

8DC6D0 

STA $D0C6 


Note, that the operand of the JSR at 0502 was changed to reflect the 
programs new location. However, the operand of the STA at 056E was not changed 
since it fell outside the range of the original program (0300 - 0380). Speci¬ 
fically, the algorithm for changing operands is: 

Each three-byte instruction operand which specifies an address 
within the originating range of the move is adjusted by adding to 
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it the difference between its final address and its original 
address, i.e.: 

final operand = original operand + final address - original address 
Thus, the operand of the JSR instruction in the above example was 
changed as follows: 

056E = 036E + 0502 - 0302 

Note, that not all programs are directly relocatable. Any program with 
/data embedded between instructions may not relocate properly because the 
relocation routine is likely to misread some data as 6500 opcodes. One 
possible remedy for this situation is to fill all data bytes and tables within 
the program with a non-relocatable opcode such as 00, then relocate the pro¬ 
gram, then restore the data. Programs can also be unrelocatable due to the 
use of addresses in immediate operands and addresses in data. However, it is 
possible to code programs so that they are directly relocatable, if desired, 
by refraining from the use of relocatable addresses in data and immediate 
instructions and by locating all data after all instructions in a program. 

Then a single relocate command for the instructions and a single move command 
for the data will relocate a complete program. 
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Using Breakpoints for Program Debuqgin 

As the name implies, a breakpoint is a point where the execution of a 
running program may be "broken" or interrupted. Using the Extended Monitor, 
up to eight breakpoints may be placed into a program. When the program is 
run (executed) and a breakpoint is encountered, the Extended Monitor is re¬ 
entered and prints the following to document the breakpoint: 

Bn@aaaa 

A/aa X/xx Y/yy P/pp K/kk 

where: n is the breakpoint number 1-8 

aaaa is the location where the breakpoint was encountered 
aa is the contents of the accumulator 

XX is the contents of the X index register 

yy is the contents of the Y index register 

pp is the contents of the processor status word 

kk is the contents of the stackpointer 

To illustrate the use of a breakpoint, consider the following portion 
of a program: 


0350 

8003 

BCS $0355 

0352 

4C8003 

JMP $0380 

0355 

200005 

JSR $0500 


If a breakpoint were installed at 0350 (by the command, "81,0350"), the 
opcode 80 would be saved and a BRK opcode, 00, would be installed in its place. 
Then, when the program is executed and the breakpoint at location 0350 is "hit", 
the Extended Monitor would print, for example: 

8100350 

A/41 X/00 Y/13 P/35 K/FC 

and breakpoint 1 would automatically be eliminated, i.e., the BRK opcode would 
be removed from location 0350 and the original opcode, 80, reinstalled. Upon 


I 
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examination of the status register (P), we find that the carry flag is set 
so the program will take the BCS branch to 0355. If you would prefer to fall 
through the BCS to the JMP instruction, you could simply reset the carry flag 
in the processor status register by typing "P" then "34". Then, when the 
continue command ("C") is given, the BCS branch will not be taken. 

Note: Extended Monitor temporaries are stored in page zero locations 
C0 through FF. Care should be taken not to alter these loca¬ 
tions with the program being debugged. 

/ If the Extended Monitor is entered by a BRK that was not installed as a 
breakpoint, a "?" will be printed. The location of the BRK may be determined 
with the "I" command. 
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Extended Monitor Command Summary 


Command 

@aaaa 

A, X, Y, P or K 

/ 

Bn,aaaa 

C 

Dffff.tttt 

En 

Fffff,tttt=dd 
Gaaaa 

Hxxxx,yyyy+ 

I 

L 

Maaaa=ffff,tttt 
Ndd...dd>ffff,tttt 

0 

Qaaaa 

Raaaa=ffff,tttt 
Sffff,tttt 
T 
V 

Wc.. .offff ,tttt 


Function 


display contents of aaaa 


display A, X, Y, P or K from last 
break 

A, X, Y - processor register 
P - processor status 
K - stackpointer 

enter breakpoint n at aaaa 

continue from last breakpoint 

dump ffff through tttt-1 

eliminate breakpoint n 

fill ffff through tttt-1 with dd 

go to aaaa 

display xxxx+yyyy 

display location of last breakpoint 

load memory from cassette 

move ffff through tttt-1 to aaaa 

search ffff through tttt-1 for 
dd...dd 

display overflow/remainder from 
last H command 

disassemble from aaaa 

relocate ffff through tttt-1 to aaaa 

save ffff through tttt-1 to cassette 

display breakpoint table 

view from cassette 

search ffff through tttt-1 for 
c.. .c 


Subcommands 

(<CCR>always returns to 

dd change aaaa 
"display as character 
<LF> display next locatior 
f display previous locatic 

dd change register 
" display as character 


(n = 1-8) 


(also -, *, /) 


space key returns to 


(dd...dd is 1-8 bytes) 


<IF> continue disassembly 


space key return:, to 
(c...c is 1-8 characters) 
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Appendix A 
0S-65D V3.0 Version 
of the 

Extended Monitor 



In 0S-65D V3.0, the Extended Monitor is loaded from disk and initiated 
by typing EM after the A* prompter in the DOS kernel command mode. Whenever 
^xiting to the DOS, you can return to the Extended Monitor as long as it is 
loaded by typing RETURN EM. 

This version of the Extended Monitor occupies memory from 1700 through 
IFFF and uses page zero locations C0 through FF. 
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Appendix B 

C2P - IP Cassette Version 
of the 

Extended Monitor 


This version of the Extended Monitor is supplied on an auto-load 
cassette tape. The following procedure may be used to load the Extended 


/ 


Monitor from tape: 

Loading the Extended Monitor 


1. Apply power to your personal computer then reset it by pressing 
the break key. Load the cassette, label up, into the cassette 
machine and turn the cassette machine on with the volume at 
about mid-range. 

2. Type "ML". 

The M initiates the 65 VP monitor and the L starts the auto-load. 

In a few seconds the four zeros in the upper left portion of the 
video monitor should change to an incrementing address value with 
a rapidly changing data field. The value of the address is dependent 
on which auto-load cassette is being read. At this time a checksum 
loader is being read into memory in 65VP format. Upon completion 
(no more than 30 seconds), the checksum loader will load the rest of 
the cassette. The Extended Monitor comes up with the prompter 


Should a checksum error occur, the following message is printed: 

OBJECT LOAD CHECKSUM ERR 

REWIND PAST ERR - TYPE G TO RESTART 


If a checksum error consistently happens at the same location, the cassette 
is probably bad - contact your OSI dealer concerning replacement. However, 
should checksum errors occur randomly at various locations, it is most likely 
that there is a problem with the cassette machine, or the connection to the 
computer. Check for broken or frayed connections. Make sure that the play¬ 
back head and pressure roller/capstan assembly is clean. With a minimal 
amount of care, no problems with auto-load cassettes should be encountered. 

This version of the Extended Monitor contains one additional instruction 
for dumping the contents of memory on the 24 character IP video screen: 

Command Function Subcommand 


Zaaaa dumps 8 bytes from aaaa <LF> dumps next 8 bytes 
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This version occupies memory from 0800 through 0FFF and uses page zero 
locations D0 through FF. The checksum loader used to load the Extended Monitor 
occupies locations 0700 through 07EF. 

This version of the Extended Monitor is normally entered at 0800. This 
causes the stackpointer to be set to 01FF and the breakpoint registers to be 
initialized. Under certain circumstances, it may be desirable to re-enter the 
Extended Monitor without this initialization. This may be done by entering it 
at 081F. 

There are two free command letters - J and U, that can be utilized by in¬ 
serting the address of a command routine at 0974 for J or 098A for U. The 
machine language command routine must end with an RTS instruction. 
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